home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglnormal.z / fglnormal
Encoding:
Text File  |  2001-04-17  |  7.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllNNNNoooorrrrmmmmaaaallll((((3333GGGG))))                  OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                  ffffggggllllNNNNoooorrrrmmmmaaaallll((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllNNNNoooorrrrmmmmaaaallll3333bbbb,,,, ffffggggllllNNNNoooorrrrmmmmaaaallll3333dddd,,,, ffffggggllllNNNNoooorrrrmmmmaaaallll3333ffff,,,, ffffggggllllNNNNoooorrrrmmmmaaaallll3333iiii,,,, ffffggggllllNNNNoooorrrrmmmmaaaallll3333ssss,,,,
  10.      ffffggggllllNNNNoooorrrrmmmmaaaallll3333bbbbvvvv,,,, ffffggggllllNNNNoooorrrrmmmmaaaallll3333ddddvvvv,,,, ffffggggllllNNNNoooorrrrmmmmaaaallll3333ffffvvvv,,,, ffffggggllllNNNNoooorrrrmmmmaaaallll3333iiiivvvv,,,, ffffggggllllNNNNoooorrrrmmmmaaaallll3333ssssvvvv -
  11.      set the current normal vector
  12.  
  13.  
  14. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  15.      SUBROUTINE ffffggggllllNNNNoooorrrrmmmmaaaallll3333bbbb( INTEGER*1 _n_x,
  16.                              INTEGER*1 _n_y,
  17.                              INTEGER*1 _n_z )
  18.      SUBROUTINE ffffggggllllNNNNoooorrrrmmmmaaaallll3333dddd( REAL*4 _n_x,
  19.                              REAL*4 _n_y,
  20.                              REAL*4 _n_z )
  21.      SUBROUTINE ffffggggllllNNNNoooorrrrmmmmaaaallll3333ffff( REAL*4 _n_x,
  22.                              REAL*4 _n_y,
  23.                              REAL*4 _n_z )
  24.      SUBROUTINE ffffggggllllNNNNoooorrrrmmmmaaaallll3333iiii( INTEGER*4 _n_x,
  25.                              INTEGER*4 _n_y,
  26.                              INTEGER*4 _n_z )
  27.      SUBROUTINE ffffggggllllNNNNoooorrrrmmmmaaaallll3333ssss( INTEGER*2 _n_x,
  28.                              INTEGER*2 _n_y,
  29.                              INTEGER*2 _n_z )
  30.  
  31.  
  32. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  33.      _n_x, _n_y, _n_z
  34.                Specify the x, y, and z coordinates of the new current normal.
  35.                The initial value of the current normal is the unit vector, (0,
  36.                0, 1).
  37.  
  38. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  39.      SUBROUTINE ffffggggllllNNNNoooorrrrmmmmaaaallll3333bbbbvvvv( CHARACTER*8 _v )
  40.      SUBROUTINE ffffggggllllNNNNoooorrrrmmmmaaaallll3333ddddvvvv( CHARACTER*8 _v )
  41.      SUBROUTINE ffffggggllllNNNNoooorrrrmmmmaaaallll3333ffffvvvv( CHARACTER*8 _v )
  42.      SUBROUTINE ffffggggllllNNNNoooorrrrmmmmaaaallll3333iiiivvvv( CHARACTER*8 _v )
  43.      SUBROUTINE ffffggggllllNNNNoooorrrrmmmmaaaallll3333ssssvvvv( CHARACTER*8 _v )
  44.  
  45.  
  46. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  47.      _v    Specifies a pointer to an array of three elements:  the x, y, and z
  48.           coordinates of the new current normal.
  49.  
  50. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  51.      The current normal is set to the given coordinates whenever ffffggggllllNNNNoooorrrrmmmmaaaallll is
  52.      issued.  Byte, short, or integer arguments are converted to floating-
  53.      point format with a linear mapping that maps the most positive
  54.      representable integer value to 1.0, and the most negative representable
  55.      integer value to -1.0.
  56.  
  57.      Normals specified with ffffggggllllNNNNoooorrrrmmmmaaaallll need not have unit length.  If
  58.      GGGGLLLL____NNNNOOOORRRRMMMMAAAALLLLIIIIZZZZEEEE is enabled, then normals of any length specified with
  59.      ffffggggllllNNNNoooorrrrmmmmaaaallll are normalized after transformation.  If GGGGLLLL____RRRREEEESSSSCCCCAAAALLLLEEEE____NNNNOOOORRRRMMMMAAAALLLL is
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllNNNNoooorrrrmmmmaaaallll((((3333GGGG))))                  OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                  ffffggggllllNNNNoooorrrrmmmmaaaallll((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      enabled, normals are scaled by a scaling factor derived from the
  75.      modelview matrix.  GGGGLLLL____RRRREEEESSSSCCCCAAAALLLLEEEE____NNNNOOOORRRRMMMMAAAALLLL requires that the originally
  76.      specified normals were of unit length, and that the modelview matrix
  77.      contain only uniform scales for proper results.  To enable and disable
  78.      normalization, call ffffggggllllEEEEnnnnaaaabbbblllleeee and ffffggggllllDDDDiiiissssaaaabbbblllleeee with either GGGGLLLL____NNNNOOOORRRRMMMMAAAALLLLIIIIZZZZEEEE or
  79.      GGGGLLLL____RRRREEEESSSSCCCCAAAALLLLEEEE____NNNNOOOORRRRMMMMAAAALLLL.  Normalization is initially disabled.
  80.  
  81. NNNNOOOOTTTTEEEESSSS
  82.      The current normal can be updated at any time.  In particular, ffffggggllllNNNNoooorrrrmmmmaaaallll
  83.      can be called between a call to ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding call to
  84.      ffffggggllllEEEEnnnndddd.
  85.  
  86. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  87.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____NNNNOOOORRRRMMMMAAAALLLL
  88.      ffffggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____NNNNOOOORRRRMMMMAAAALLLLIIIIZZZZEEEE
  89.      ffffggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____RRRREEEESSSSCCCCAAAALLLLEEEE____NNNNOOOORRRRMMMMAAAALLLL
  90.  
  91.  
  92. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  93.      ffffggggllllBBBBeeeeggggiiiinnnn, ffffggggllllCCCCoooolllloooorrrr, ffffggggllllIIIInnnnddddeeeexxxx, ffffggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ffffggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd, ffffggggllllVVVVeeeerrrrtttteeeexxxx
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.